Annotations and Labels used by Argo CD

Annotations

Annotation keyTarget resource(es)Possible valuesDescription
argocd.argoproj.io/application-set-refreshApplicationSet“true”Added when an ApplicationSet is requested to be refreshed by a webhook. The ApplicationSet controller will remove this annotation at the end of reconciliation.
argocd.argoproj.io/compare-optionsanysee compare options docsConfigures how an app’s current state is compared to its desired state.
argocd.argoproj.io/hookanysee resource hooks docsUsed to configure resource hooks.
argocd.argoproj.io/hook-delete-policyanysee resource hooks docsUsed to set a resource hook’s deletion policy.
argocd.argoproj.io/manifest-generate-pathsApplicationsee scaling docsUsed to avoid unnecessary Application refreshes, especially in mono-repos.
argocd.argoproj.io/refreshApplicationnormal, hardIndicates that app needs to be refreshed. Removed by application controller after app is refreshed. Value “hard” means manifest cache and target cluster state cache should be invalidated before refresh.
argocd.argoproj.io/skip-reconcileApplication“true”Indicates to the Argo CD application controller that the Application should not be reconciled. See the skip reconcile documentation for use cases.
argocd.argoproj.io/sync-optionsanysee sync options docsProvides a variety of settings to determine how an Application’s resources are synced.
argocd.argoproj.io/sync-waveanysee sync waves docs
argocd.argoproj.io/tracking-idanyanyUsed by Argo CD to track resources it manages. See resource tracking docs for details.
link.argocd.argoproj.io/{some link name}anyAn http(s) URLAdds a link to the Argo CD UI for the resource. See external URL docs for details.
pref.argocd.argoproj.io/default-pod-sortApplicationsee UI customization docsSets the Application’s default grouping mechanism.
pref.argocd.argoproj.io/default-viewApplicationsee UI customization docsSets the Application’s default view mode (e.g. “tree” or “list”)

Labels

Label keyTarget resource(es)Possible valuesDescription
argocd.argoproj.io/instanceApplicationanyRecommended tracking label to [avoid conflicts with other tools which use app.kubernetes.io/instance](../faq.md#why-is-my-app-out-of-sync-even-after-syncing.
argocd.argoproj.io/secret-typeSecretcluster, repository, repo-credsIdentifies certain types of Secrets used by Argo CD. See the Declarative Setup docs for details.